docs(agents): add host contribution guide - #23
Merged
Conversation
Document an evidence-first workflow for adding Coding Agent hosts, drawing bounded lessons from PR #6 and PR #22. Link the canonical guide from contributor entry points and publish concise English and zh-Hans site routes. The change follows docs/specs/2026-07-30-new-coding-agent-contribution-guide.md and was validated with the 7/7 documentation checks, 867/867 full tests, the two-locale Docusaurus build, package verification, and git diff checks. Co-authored-by: Codex (GPT 5.6 Sol) <codex@openai.com>
phodal
marked this pull request as ready for review
July 30, 2026 02:43
9 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add one evidence-first contribution workflow for supporting a new Coding Agent
host. The guide separates native discovery, configured assets, session evidence,
shared registration, output routing, and packaging so contributors can land
partial support without overstating coverage.
The guide links PR #6 (Qwen Code) and PR #22 (GitHub Copilot) as contrasting
worked examples while making current repository contracts the source of truth.
It is discoverable from AGENTS.md, CONTRIBUTING.md, the English and Chinese
READMEs, Community Extensibility, the canonical Host Adapter Matrix, and new
English/zh-Hans Docusaurus pages.
Why
turn two host contributions into a reusable contributor route.
slices they are claiming, find their canonical owners, and attach appropriate
native, privacy, cross-platform, test, packaging, and review evidence.
Traceability and Scope
docs/specs/2026-07-30-new-coding-agent-contribution-guide.mdNCAG-AC-1throughNCAG-AC-6docs/adapters/, contributor entry pages, and thecurated English/zh-Hans Hosts site routes.
report mode, packaging target, PR feat(host): add Qwen Code host adapter #6 change, or PR feat(copilot): add GitHub Copilot as a first-class host platform #22 change.
Change Type
Test and Review Evidence
node scripts/doc-link-graph/cli.mjs skills/better-harnessnode --test test/doc-link-graph.test.mjs test/docs-site.test.mjsnpm ci && npm run buildfromdocs/npm testnpm run pack:verifygit diff --checkManual evidence: inspected every new navigation route and both external PR
links. No visual grammar or layout changed, so no new screenshot is included.
Risk and Recovery
explicitly requires Windows, macOS, and Linux evidence proportional to future
host changes.
dependency, or generated graph changes. Canonical repository Markdown may be
present in documented package roots; Docusaurus source remains excluded by
existing package boundaries.
4b6f722.contributors to verify current host versions and defers to current repository
owners.
npm cireported audit findings from the unchanged docs lockfile; thisPR does not change dependencies.
AI Involvement
automated and source-backed checks completed by Codex for maintainer review.
Checklist
AGENTS.md,CONTRIBUTING.md, and the relevant canonical-owner guidance.CHANGELOG.mdis not required because this adds contributor guidance without changing user-facing runtime behavior.